home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / apidev / tpapi.exe / DOCS / OLDDOCS.LZH / NWCONN.DOC < prev    next >
Text File  |  1992-10-26  |  8KB  |  185 lines
  1.                               CONNECTION SERVICES
  2.                               ===================
  3.  
  4. --------------------------------------------------------------------------------
  5.  
  6.   AttachToFileServer (ServerName : ObjectNameType;
  7.                       VAR ConnectionID : WORD) : WORD;
  8.  
  9.     Creates an attachment between a workstation and a specified file server.
  10.  
  11.     ServerName (Input)                : string containing the name of the file
  12.                                         server to attach to.
  13.  
  14.     ConnectionID (Output)             : the connectionID for the attached to
  15.                                         file server.
  16.  
  17. --------------------------------------------------------------------------------
  18.  
  19.   AttachToFileServerWithAddress (ServerName : ObjectNameType;
  20.                                  VAR ConnectionID : WORD;
  21.                                  NetAddress : ServerAddressType) : WORD;
  22.  
  23.     Creates an attachment between a workstation and a specified file server.
  24.  
  25.     ServerName (Input)                : string containing the name of the file
  26.                                         server to attach to.
  27.  
  28.     ConnectionID (Output)             : the connectionID for the attached to
  29.                                         file server.
  30.  
  31.     NetAddress (Input)                : address of the file server to attach to.
  32.  
  33. --------------------------------------------------------------------------------
  34.  
  35.   DetachFromFileServer (ConnectionID : WORD) : WORD;
  36.  
  37.     Logs out the bindery object and detaches the requesting workstation from the
  38.     specified file server.
  39.  
  40.     ConnectionID (Input)              : ConnectionID of the server to detach
  41.                                         from.
  42.  
  43. --------------------------------------------------------------------------------
  44.  
  45.   EnterLoginArea (LoginSubdirectoryName : PathNameType;
  46.                   NumberOfLocalDrives : WORD) : WORD;
  47.  
  48.     Changes the login directory of the requesting workstation.
  49.     NOTE : Applies to file servers running Netware prior to v2.1x.
  50.  
  51.     LoginSubdirectoryName (Input)     : string containing the subdirectory name
  52.                                         with SYS:LOGIN where login.exe resides.
  53.  
  54.     NumberOfLocalDrives (Input)       : Number of local drives at workstation.
  55.  
  56. --------------------------------------------------------------------------------
  57.  
  58.   GetConnectionInformation (ConnectionNumber : WORD;
  59.                             VAR ObjectName : ObjectNameType;
  60.                             VAR ObjectType : OT_BinderyType;
  61.                             VAR ObjectID : OT_BinderyID;
  62.                             VAR LoginTime : Byte7ArrayType) : WORD;
  63.  
  64.     Returns information about the object logged in to a specified connection.
  65.  
  66.     ConnectionNumber (Input)          : workstation connection number for which
  67.                                         the information is to be returned.
  68.  
  69.     ObjectName (Output)               : string containing the object name of
  70.                                         the logged in object.
  71.  
  72.     ObjectType (Output)               : receives the type of the object that is
  73.                                         logged in.
  74.  
  75.     ObjectID (Output)                 : receives the unique ID of the logged in
  76.                                         object. (0 = unused connection number)
  77.  
  78.     LoginTime (Output)                : receive the date and time that the
  79.                                         object logged in.
  80.  
  81.                                         Byte  Contents
  82.  
  83.                                          0     Year
  84.                                          1     Month
  85.                                          2     Day
  86.                                          3     Hour
  87.                                          4     Minute
  88.                                          5     Second
  89.                                          6     Day (0 = Sunday, 1 = Monday etc)
  90.  
  91. --------------------------------------------------------------------------------
  92.  
  93.   GetConnectionNumber : WORD;
  94.  
  95.     Returns the connection number that the requesting workstation uses to
  96.     communicate with the default file server.
  97.  
  98. --------------------------------------------------------------------------------
  99.  
  100.   GetInternetAddress (ConnectionNumber : WORD;
  101.                       VAR NetworkNumber : Byte4ArrayType;
  102.                       VAR PhysicalNodeAddress : Byte6ArrayType;
  103.                       VAR SocketNumber : WORD) : WORD;
  104.  
  105.     Returns a connection's internetwork address.
  106.  
  107.     ConnectionNumber (Input)          : connectionnumber of a workstation for
  108.                                         which the internet address is to be
  109.                                         obtained.
  110.  
  111.     NetworkNumber (Output)            : receives the network number.
  112.  
  113.     PhysicalNodeAddress (Output)      : receives the physical node address
  114.  
  115.     SocketNumber (Output)             : receives the socket number which the
  116.                                         shell uses to communicate with the file
  117.                                         server.
  118.  
  119. --------------------------------------------------------------------------------
  120.  
  121.   GetObjectConnectionNumbers (ObjectName : ObjectNameType;
  122.                               ObjectType : OT_BinderyType;
  123.                               VAR NumberOfConnections : WORD;
  124.                               VAR ConnectionList : ConnectionListType;
  125.                               MaxConnections : WORD) : WORD;
  126.  
  127.     Returns a list of connection numbers that indicate how many times and under
  128.     what connection numbers a bindery object is logged in to the default file
  129.     server.
  130.  
  131.     ObjectName (Input)                : name of the bindery object for which to
  132.                                         find.
  133.  
  134.     ObjectType (Input)                : the object type.
  135.  
  136.     NumberOfConnections (Output)      : the number of times the object is logged
  137.                                         in.
  138.  
  139.     ConnectionList (Output)           : the list of connection numbers for which
  140.                                         the object is logged in.
  141.  
  142.     MaxConnections (Input)            : the maximum number of connections that
  143.                                         can be returned in ConnectionList.
  144.  
  145. --------------------------------------------------------------------------------
  146.  
  147.   GetStationAddress (VAR PhysicalNodeAddress : Byte6ArrayType);
  148.  
  149.     Returns the physical node address of the requesting workstation.
  150.  
  151.     PhysicalNodeAddress (Output)      : the physical node address of the
  152.                                         requesting workstation.
  153.  
  154. --------------------------------------------------------------------------------
  155.  
  156.   LoginToFileServer (ObjectName : ObjectNameType; ObjectType : OT_BinderyType;
  157.                      ObjectPassword : PasswordType) : WORD;
  158.  
  159.     Logs a bindery object in to the default file server.
  160.  
  161.     ObjectName (Input)                : string containing the object name to be
  162.                                         logged in.
  163.  
  164.     ObjectType (Input)                : bindery type of the object to be logged
  165.                                         in.
  166.  
  167.     ObjectPassword (Input)            : the bindery object password.
  168.  
  169. --------------------------------------------------------------------------------
  170.  
  171.   Logout
  172.  
  173.     Issues a network logout request to all connected file servers.
  174.  
  175. --------------------------------------------------------------------------------
  176.  
  177.   LogoutFromFileServer (ConnectionID : WORD);
  178.  
  179.     Logs out the object but does not detach the workstation from the file server.
  180.  
  181.     ConnectionID (Input)              : connectionID of the server to be logged
  182.                                         out from.
  183.  
  184. --------------------------------------------------------------------------------
  185.